Improve accessibility - #4
Merged
Merged
Conversation
Member
|
Thanks @ryanlovett! |
cycomachead
reviewed
May 12, 2026
| pdfstandard=a-2u, % PDF/A-2u format (archival standard with Unicode support) | ||
| pdfstandard=ua-1, % Add PDF/UA-1 accessibility conformance target | ||
| pdfstandard=ua-2, | ||
| pdfversion=1.7, % Explicit PDF version used for compatibility with conformance tooling |
There was a problem hiding this comment.
I'm late to this, but I think we should probably start targeting pdf 2.0 standard documents. 2.0 is required for MathML and UA-2 is designed to work with 2.0. (Older readers can still open 2.0 documents, and even though they score less on checkers, I think that will be an anti-pattern soon enough.)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
These changes improve accessibility scoring from two different accessibility checkers. The main differences are using lualatex instead of xetex and adding tags. I needed to install TeX Live 2025. I don't know LaTeX very well, and relied on @rhstanton's work in https://github.com/rhstanton/accessible_LaTeX/. All shortcomings are mine.
The tools I used to measure accessibility.
myst build --pdf docker run --platform linux/amd64 --rm -it -v .:/data ghcr.io/verapdf/cli:latest \ --format json -df ua2 --loglevel 0 \ exports/myst-latex.pdf > verapdf-analysis.jsonMy local myst project referenced my local fork:
My
index.mdtest file contained:(I tried several table variants besides
csv-table.)When I generated verapdf json output with the current lapreprint code and summarized with:
When I ran it with my changes:
The remaining failure is related to tables and tagging, and I believe that would need to be fixed in myst.
Cc: jupyter-book/mystmd#2743
myst-latex-upstream.pdf
myst-latex-fixes.pdf